PATHMac OS 8 Developer Documentation > Operating System Services > Multiprocessing Services >

Adding Multitasking Capability to Applications Using Multiprocessing Services

   

MPNotifyQueue

Sends a message to the specified message queue.

OSStatus MPNotifyQueue (
                     MPQueueID queue,
                     void *param1,
                     void *param2,
                     void *param3);
queue
A value of type MPQueueID that specifies the queue ID of the message queue you want to notify.
param1
The first 32-bits of the message to send.
param2
The second 32-bits of the message to send.
param3
The third 32-bits of the message to send.
function result
A result code. See Result Codes for a list of possible values.
DISCUSSION

This function sends a message to the specified queue, which consist of the three parameters, param1 , param2 , and param3 . The system does not interpret the three 32-bit words which comprise the text of the message. If tasks are waiting on the specified queue, the first waiting task is unblocked and the task's MPWaitOnQueue function completes.

Depending on the queue mode, the system either allocates messages dynamically or assigns them to memory reserved for the queue. In either case, if no more memory is available for messages MPNotifyQueue returns kMPInsufficientResourcesErr .

You can call this function from an interrupt handler if messages are reserved on the queue. For more information about queueing modes and reserving messages, see MPSetQueueReserve .

VERSION NOTES

Introduced with Multiprocessing Services 1.0.

SEE ALSO

The function MPWaitOnQueue .

© 1999 Apple Computer, Inc. – (Last Updated 07 May 99)